# DiaGramma_1.0.2 - クイックガイド

## このアドインでできること

DiaGramma_1.0.2 は、Excel 上で選択したデータ範囲から、
花粉ダイアグラムを SVG 形式で出力するアドインです。

出力された SVG は、Adobe Illustrator などのベクター編集ソフトで
開いて、仕上げの編集・レイアウト調整・図版作成を行うことを
前提としています。

---

## 1. アドインのインストール

1. `DiaGramma_1.0.2` を、英数字のみのパスにある
   フォルダに置きます。

   推奨例：

   `/Users/yourname/Documents/DiaGramma/`

2. Excel を開きます。

3. メニューから

   `ツール > Excel アドイン...`

   を開きます。

4. `参照...` をクリックします。

5. `DiaGramma_1.0.2.xlam` を選びます。

6. アドイン一覧で DiaGramma にチェックが入っていることを確認します。

7. Ribbon に **Pollen diagram** タブが表示されれば準備完了です。

---

## 2. データの準備

データは次のような形で並べてください。

| Composite depth | Taxon A | Taxon B | Taxon C |
|---|---:|---:|---:|
| 0.10 | 12 | 4 | 0 |
| 0.20 | 15 | 3 | 1 |
| 0.30 | 0 | 0 | 0 |
| 0.40 | 8 | 2 | 5 |

基本ルール：

- 1列目は depth（深度）です
- 2列目以降は taxon ごとの値です
- 1行目には taxon 名を入れることができます
- すべての taxon 値が 0 の行は separator row として扱われます
- separator row はグラフを視覚的に分割します

---

## 3. 出力する範囲を選ぶ

出力したい範囲を Excel 上で選択します。

選択できるのは：

- ヘッダー行を含む範囲
- データの一部分だけの範囲

のどちらでも大丈夫です。

データの一部分だけを選んだ場合でも、DiaGramma は各列の上方向を検索して、
taxon 名を自動的に見つけようとします。

---

## 4. ダイアグラムを出力する

1. データ範囲を選択します。
2. Ribbon の **Pollen diagram** タブを開きます。
3. 5種類の描画スタイルのうち、使いたいボタンをクリックします。
4. 表示される入力欄にファイル名を入力します。
5. SVG は元の Excel ブックと同じフォルダに保存されます。

ファイル名に `.svg` を付けなかった場合でも、自動的に追加されます。

---

## 5. 描画スタイルを選ぶ

### Area Only
塗りつぶし面グラフのみを出力します。  

### Bars Only
横棒だけを出力します。  

### Line Only
折れ線だけを出力します。  

### Area + Bars
輪郭と sample bar の両方を出力します。
DiaGramma の標準スタイルです。  

### Line + Points
折れ線と丸いデータ点を出力します。  

---

## 6. Illustrator で開く

出力後、SVG ファイルを Adobe Illustrator で開いてください。

Illustrator では、たとえば次のような編集ができます。

- 分類群ごとに選択・編集する
- 線の太さや色を変える
- 塗りを変更する
- Bars の太さを調整する
- Point markers の大きさを変える
- 最終的な図のレイアウトを整える

DiaGramma は、図を自動的にページに収めたりはしません。
最終的な縮尺調整やレイアウトは Illustrator 側で行ってください。

---

## 7. 初期ベータ版での注意点

これは初期ベータ版です。

以下の点に注意してください。

- 主に Mac Excel でテストしています
- フォルダ名やファイル名に日本語などの非 ASCII 文字があると、
  エラーになることがあります
- エラーが出た場合は、Excel ブックとアドインを英数字のみのフォルダに
  移して試してください

  例：

  `/Users/yourname/Documents/DiaGramma/`

- SVG は元の Excel ブックと同じフォルダに保存されます
- Ribbon アイコンは、このベータ版では仮のものです

---

## 8. うまくいかないとき

不具合を報告するときは、できれば次の情報を添えてください。

- Excel のバージョン
- OS
- workbook の保存場所
- 選択したデータ範囲
- 使用した描画スタイル
- 可能ならエラーメッセージのスクリーンショット